Qt5.2文档翻译：QPainter类,QPainter Class

StupidBeauty

Articles
Now reading
User manage
Category
Blind Box

Read times:1821Posted at:

- no title specified

Qt5.2文档翻译：QPainter类,QPainter Class

成员类型文档

enum QPainter::CompositionMode

定义了所支持的那些数字图片合成模式。合成模式，指的是，源图片中的那些像素，应当如何与目标图片中的像素合并起来。

请注意，那些以 RasterOp 前缀开头的按位进行的光栅操作模式，只在X11 和光栅绘图引擎中被原生支持。这就意味着，在 Mac 上，唯一一个利用这些模式的方式就是，使用 QImage 。对于带有透明分量的画笔和画刷，以RasterOp 开头的混合模式是不被支持的。另外，开启 QPainter::Antialiasing 这个渲染建议的话，也会禁用掉RasterOp 模式。

最常见的类型是SourceOver (通常被称作透明混合) ，这种模式下，源图片中的像素被混合到目标图片的对应像素之上，并且，源图片中的透明分量定义了该像素的透明度。

当绘图设备是一个 QImage 的时候，图片格式必须被设置为 Format_ARGB32_Premultiplied 或 Format_ARGB32 ，才能使得这些合成模式产生真正的效果。出于性能方面的考虑，预乘版本的格式是首选的格式。

当设置了合成模式之后，它就会应用到所有的绘图操作符、画笔、画刷、渐变和位图/图片绘制操作上。

常量	值	说明
QPainter::CompositionMode_So urceOver	0	这是默认模式。源图片中的透明分量被用于将当前像素混合到目标图片的对应像素上。
QPainter::CompositionMode_DestinationOver	1	目标图片中的透明分量被用于将当前像素混合到源图片的对应像素上。这个模式与CompositionMode_SourceOver 相反。
QPainter::CompositionMode_Clear	2	无论源图片中对应的像素是什么值，目标图片中的像素都会全部被清除（被设置为完全透明）。
QPainter::CompositionMode_Source	3	输出内容即为源图片中的像素。(这意味着，就是一个基本的复制操作，并且，当源图片中的像素是完全不透明的时候，此模式与SourceOver 等价)。
QPainter::CompositionMode_Destination	4	输出内容即为目标图片中的像素。这意味着，混合动作无效果。此模式与CompositionMode_Source 相反。
QPainter::CompositionMode_SourceIn	5	输出内容即为源图片中的像素，并且，其图案被目标图片中的透明分量裁减。
QPainter::CompositionMode_DestinationIn	6	输出内容即为目标图片中的像素，并且，其图案被源图片中的透明分量裁减。此模式与CompositionMode_SourceIn 相反。
QPainter::CompositionMode_SourceOut	7	输出内容即为源图片中的像素，并且，其图案被目标图片中透明分量的相反图案裁减。
QPainter::CompositionMode_DestinationOut	8	输出内容即为目标图片中的像素，并且，其图案被源图片中透明分量的相反图案裁减。此模式与CompositionMode_SourceOut相反。
QPainter::CompositionMode_SourceAtop	9	源图片中的像素被覆盖于目标图片的对应像素之上，并且，源图片中的像素被目标图片中的透明分量裁减。
QPainter::CompositionMode_DestinationAtop	10	目标图片中的像素被覆盖于源图片的对应像素之上，并且，目标图片中的像素被源图片中的透明分量裁减。此模式与CompositionMode_SourceAtop 相反。
QPainter::CompositionMode_Xor	11	源图片中的像素被目标图片中透明分量的相反图案裁减，目标图片中的像素被源图片中透明分量的相反图案裁减，然后，二者合并。 CompositionMode_Xor与按位进行的Xor不同。
QPainter::CompositionMode_Plus	12	源图片和目标图片的透明分量和颜色值都会相加。
QPainter::CompositionMode_Multiply	13	输出内容为，源图片中的颜色与目标图片中的颜色相乘。将一个颜色与白色相乘，则会让它保持原来的颜色，将一个颜色与黑色相乘，会让它变成黑色。
QPainter::CompositionMode_Screen	14	源图片和目标图片中的颜色，首先被反转，然后相乘。使用白色来对一个颜色进行筛选（Screening）操作，会产生白色，而使用黑色来对一个颜色进行筛选操作，会让该颜色保持原样。
QPainter::CompositionMode_Overlay	15	按照目标图片中各个像素的颜色，来对当前像素的颜色进行相乘或筛选操作。目标图片中的颜色会与源图片中的颜色混合，以反映目标图片的明亮或黑暗属性。
QPainter::CompositionMode_Da rken	16	对于输出内容中的每个像素，会选取源图片和目标图片中较暗的那个颜色。
QPainter::CompositionMode_Lighten	17	对于输出内容中的每个像素，会选取源图片和目标图片中较亮的那个颜色。
QPainter::CompositionMode_ColorDodge	18	目标图片中各个像素的颜色会被变亮，以反映源图片中的颜色。如果源图片中某个像素是黑色的，则会让目标图片中对应像素的颜色保持不变。
QPainter::CompositionMode_ColorBurn	19	目标图片中各个像素的颜色会被变暗，以反映源图片中的颜色。如果源图片中某个像素是白色的，则会让目标图片中对应像素的颜色保持不变。
QPainter::CompositionMode_HardLight	20	按照源图片中各个像素的颜色，对当前像素的颜色进行相乘或筛选操作。明亮的源图片像素颜色会使得目标图片中相应像素的颜色变亮，黑暗的源图片像素颜色会使得目标图片中相应像素的颜色变暗。
QPainter::CompositionMode_SoftLight	21	按照源图片中各个像素的颜色，将当前像素的颜色变暗或变亮。类似于CompositionMode_HardLight。
QPainter::CompositionMode_Difference	22	将较亮的颜色减去较暗的颜色。在这种模式下，以白色绘制则会反转目标图片中的颜色，以黑色绘制则会令目标图片中的颜色保持不变。
QPainter::CompositionMode_Exclusion	23	类似于CompositionMode_Difference，但是对比度较低。在这种模式下，以白色绘制则会反转目标图片中的颜色，以黑色绘制则会令目标图片中的颜色保持不变。
QPainter::RasterOp_SourceOrDestination	24	对源图片和目标图片中对应的像素，进行一次按位的或（OR）操作（src OR dst）。
QPainter::RasterOp_SourceAndDestination	25	对源图片和目标图片中对应的像素，进行一次按位的与（AND）操作（src AND dst）。
QPainter::RasterOp_SourceXorDestination	26	对源图片和目标图片中对应的像素，进行一次按位的异或（XOR）操作（src XOR dst）。
QPainter::RasterOp_NotSourceAndNotDestination	27	对源图片和目标图片中对应的像素，进行一次按位的或非（NOR）操作（(NOT src) AND (NOT dst)）。
QPainter::RasterOp_NotSourceOrNotDestination	28	对源图片和目标图片中对应的像素，进行一次按位的与非（NAND）操作（(NOT src) OR (NOT dst)）。
QPainter::RasterOp_NotSourceXorDestination	29	将源图片中的像素值反转，然后与目标图片中对应的像素进行按位的异或操作（(NOT src) XOR dst）。
QPainter::RasterOp_NotSource	30	对源图片中的各个像素进行一次按位的非操作（NOT src）。
QPainter::RasterOp_NotSourceAndDestination	31	将源图片中的像素值反转，然后与目标图片中对应的像素进行按位的与操作（(NOT src) AND dst）。
QPainter::RasterOp_SourceAndNotDestination	32	将目标图片中的像素值反转，然后与源图片中对应的像素进行按位的与操作（src AND (NOT dst)）。
QPainter::RasterOp_NotSource OrDestination	33	将源图片中的像素值反转，然后与目标图片中对应的像素进行按位的或操作（(NOT src) OR dst）。
QPainter::RasterOp_ClearDestination	35	无论源图片中的像素是什么颜色，都对目标图片中所有的像素进行清除操作（设置为0）。
QPainter::RasterOp_SetDestination	36	无论源图片中的像素是什么颜色，都对目标图片中所有的像素进行设置操作（设置为1）。
QPainter::RasterOp_NotDestination	37	对目标图片中的各个像素进行一次按位的非操作（NOT dst）。
QPainter::RasterOp_SourceOrNotDestination	34	将目标图片中的像素值反转，然后与源图片中对应的像素进行按位的或操作（src OR (NOT dst)）。